home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / fmsud15.zip / FMSUD.DOC < prev    next >
Text File  |  1990-07-14  |  11KB  |  301 lines
  1.                         FMS UpDate  Ver 1.5  for RBBS-PC
  2.                               (c) Copyright 1990
  3.                                       by
  4.                                 Brian E. Baker
  5.                             SysOp 21st Century BBS
  6.                                 (208) 336-3565
  7.                         9600, N,8,1 Hayes & USRobotics
  8.  
  9. In keeping with the tradition of RBBS-PC, where not one but many sysop's
  10. from around the world have contributed to make RBBS-PC the best
  11. BULLETIN BOARD program available.
  12.  
  13. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  14.  
  15.     This program is provided as SHAREWARE for a meager $10.00.
  16. If you wish to register the program send a check or money order to:
  17.                 
  18.                          Brian E. Baker
  19.                          418 Pueblo
  20.                          Boise, ID 83702
  21.                          (208)-385-9943
  22.                       
  23. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  24.  
  25.  
  26.                                   DISCLAIMER
  27.                                   ~~~~~~~~~~
  28.  
  29.     This product  is provided "AS IS" without warranties of any kind. The
  30. entire risk as to the results and performance  of this program is assumed
  31. by you the user. Further more, I the author do not warranty, guarantee, or
  32. make any representations  regarding the use of,  or the result of the use
  33. of  this  program. I the  author cannot  accept responsibility for system
  34. damage, loss of profit or any other special, incidental, or consequential
  35. damages resulting from the use or inability to use this product. In other
  36. words, use this program at you own risk.
  37.  
  38. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  39.  
  40. FMSUD11.ZIP      The following files are provided in this archive file.
  41.  
  42. FMSUD.EXE        Main file, just load and answer 3 simple questions.
  43.  
  44. DIRLIST          Edit this file to match your UP/DNLOAD directories.
  45.  
  46. FMSUD.DOC        This file you are reading.
  47.  
  48.  
  49. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  50.  
  51. WHAT FMS UpDate DOES
  52. ~~~~~~~~~~~~~~~~~~~~
  53.  
  54.      o   Checks files in the master.dir with the actual files
  55.          in your UP/DNLOAD subdirectories.
  56.  
  57.      o   Checks the size of the files on disk and corrects the
  58.      master directory if the file sizes have changed.
  59.  
  60.      o   Deletes entries in the master.dir of files not found in
  61.          the UP/DNLOAD subdirectories.
  62.  
  63.      o   Adds files to the master.dir which are found on the
  64.          hard drive in the specified path.
  65.  
  66.      o   Creates a file "FNFOUND.LST of all deleted files in the
  67.          new master.dir
  68.  
  69.      o   Creates a DownLoadable file list with the extended descriptions
  70.          in the right reading order.
  71.  
  72.      o   Searches the MASTER.DIR for duplicate files.
  73.  
  74.  
  75.         The reason I wrote this should be fairly obvious.  There are
  76. always new versions of data compression  programs coming out and the
  77. file sizes are  always changing if you  keep on top of things. So to
  78. help keep your master directory up to date I give you FMS UpDate.
  79.  
  80. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  81.  
  82. DIRLIST
  83. ~~~~~~~
  84.     First of all you must create a file with a list of all the
  85. directories in which files are kept.  The easiest way to do this
  86. is to copy and edit your RBBS-PC FILESEC file.  The file must look
  87. like this:
  88.  
  89. c:\file\games
  90. c:\files\pics
  91. c:\files\misc
  92. d:\bbsfiles
  93. d:\newfiles
  94. e:\morefiles
  95.  
  96. and so on. No trailing backslash is needed.
  97.  
  98.     A sample directory list is provided in the file, DIRLIST or just
  99. edit that file and rename it to whatever you wish.
  100.  
  101. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  102.  
  103.     Once this file is created all you have to do is run the program.
  104.     The main menu will give you the following options:
  105.  
  106.  
  107.  1)  UpDate FMS directory
  108.  2)  Search FMS directory for duplicate files
  109.  3)  Create DownLoadable file list
  110.  4)  Quit FMS UpDate
  111.  
  112.  
  113.  
  114. 1. Will search the Hard drive for missing files and unlisted files.
  115.    It will also make sure that the file sizes are correct.
  116.  
  117. 2. Will search the MASTER.DIR for duplicate files and give you a
  118.    listing of the ones that it found and the line numbers that they
  119.    were on.
  120.  
  121. 3. Will create a DownLoadable file list, sorting the extended description
  122.    into the right order.
  123.  
  124. 4. Exits to dos and deletes the temp. files that were needed.
  125.  
  126.  
  127.       The following pages are more detailed descriptions of how
  128.       each selection actually runs.  They are numbered as above.
  129.  
  130.  
  131.  
  132.  
  133.  
  134. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  135.                          #1 UpDate FMS Directory
  136. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  137.  
  138.                   You will be prompted for the following
  139.  
  140.  
  141. 1. The name of your master directory of files.  [EXAMPLE]   master.dir
  142.    or c:\rbbs\files\master.dir
  143.  
  144. 2. The name of the file that we just discussed. [EXAMPLE]   dirlist
  145.  
  146. 3. The name of the new file to create. [EXAMPLE]  master.new 
  147.    or c:\rbbs\files\master.new
  148.  
  149.   +  Enter full path names if other than the subdirectory you are in.
  150.  
  151. 4. What category would like the new files to be placed in [EXAMPLE]  UPL
  152.  
  153. 5. The starting position of the category code [EXAMPLE]  77
  154.      The number should be the position of the first character
  155.      in the category code.
  156.  
  157. *  6. The Indexing type (2=fast/1=slow). [EXAMPLE] 2
  158.    
  159. ** 7. Memory type (2=over 512/1=512 or less). [EXAMPLE] 2
  160.  
  161.  
  162. *  The indexing type is based on how many characters to use from the
  163.    file name to make the index files.  If you select 2 you must make
  164.    sure that the shortest file name is 2 characters or more not
  165.    counting the ext.
  166.  
  167. ** When selecting 2 for memory type make sure that DOS's SORT.EXE is
  168.    in the path.  If you have the memory the program will shell to DOS
  169.    and sort the directory files with DOS's SORT.  If you do not have
  170.    the memory it will just take a bit longer.
  171.  
  172. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  173.  
  174. SEARCHING THE HARD DRIVE
  175. ~~~~~~~~~~~~~~~~~~~~~~~~
  176.   After the program searches your MASTER.DIR you will be prompted:
  177.  
  178.   Do you want to search the Hard Drive for extra files?
  179.  
  180.   If you answer 'y' the program will search the paths that you have
  181.   in the DIRLIST file for files that are not in the MASTER.DIR.
  182.   If it finds and it will add the files to the new list in the
  183.   proper format.
  184.  
  185.   When searching the hard drive for missing files the program will
  186.   go through the same process as when you searched the MASTER.DIR.
  187.   This time it will be a bit quicker since the program already knows
  188.   a few things that it is looking for.
  189.  
  190.      
  191.  
  192.         The program will not edit your master directory in any way, that
  193. is why you are asked for the name of the new file.  If the name of
  194. the new file is the same as the master directory you will get an error
  195. and be asked to re-enter the information.
  196.  
  197. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  198.  
  199. FILES
  200. ~~~~~
  201.         The program will create a number of temporary files to free up memory.
  202. The names of the files are listed below.
  203.  
  204.     F??TFMS.TMP
  205.     DIR?INFO.TXT
  206.     ?.D34
  207.     UPDIR347.BAT
  208.  
  209.   If you have any files by this name in the default directory they will
  210.   be deleted.
  211.  
  212. After FMSUD has created your new master.dir listing it will create a file
  213. called "FNFOUND.LST" which will list all files not found and deleted from
  214. the master.new file.
  215.  
  216. FMSUD will insert  (***** FILENAME  was not found on hard drive *****)
  217.  
  218. Because there is no way for me to know how many lines of EXTENDED
  219. descriptions there are for deleted files You will have to edit out all of
  220. these with any text editor. Also remember that your extended descriptions
  221. write to the line above and not below in your master.dir file, these will
  222. also have to be edited out.
  223.  
  224.  
  225.  
  226. ****  NOTE  ****
  227.  
  228.  Every now and then you will see a 'FILE NOT FOUND' in the upper left
  229.  hand corner of the screen.  This is because the program is deleting
  230.  the temporary files before they are created.  In the first versions
  231.  of the program, I had a few problems on some machines with out a lot
  232.  of memory and the program would lock up before deleting the temporary
  233.  files.  This caused a big problem when the program was rerun because
  234.  some of the files were still there.  So don't worry about it, it is
  235.  not an error.
  236.  
  237.  
  238. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  239.                     #2 Search FMS for Duplicate files
  240. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  241.  
  242.      This selection is provided to search the master.dir for duplicate
  243. files.  If the program finds a duplicate file it will tell you which
  244. lines in which both names reside.  You may either have the output sent
  245. to the printer or a text file.  The program will ask for the name of the
  246. master.dir and whether or not you want the information sent to the printer
  247. or a file.  If you select a text file it will prompt you for a name to
  248. call the file.  Then just sit back and watch.
  249.  
  250.   **  I suggest that you run Search before running FMS UpDate
  251.   **  just to make sure that you do not have any duplicate files. 
  252.  
  253.  
  254. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  255.                   #3 Make DownLoadable file list
  256. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  257.  
  258.        This selection will search through the MASTER.DIR and cut
  259.    off the category codes and place the extended descriptions in
  260.    the order that they are displayed to the user.  You will be
  261.    prompted for the name of the MASTER.DIR and the new text file
  262.    to be created.
  263.  
  264.  
  265. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  266.  
  267. Enhancements
  268. ~~~~~~~~~~~~
  269.  
  270.    - COPYRIGHT - 1.4 and up now has (c) Copyright protection.
  271.  
  272.    - SPEED - Ver 1.4 and up will now do what 1.3 did, in 1/8 the time.
  273.  
  274.    - FMS SEARCH added into the program.  In versions 1.0 - 1.4
  275.          it was a separate program.
  276.  
  277.    - MAKE LIST added to create a DownLoadable file list for users.
  278.  
  279.  
  280. What to look for in future releases of FMS UpDate:
  281.  
  282.   o   Converting master list file extensions from ARC to ZIP ect.
  283.  
  284.   o   Setting up a configuration file so you do not have to enter
  285.       the information in all the time.
  286.  
  287.   o   Command line options so you may run program unattended.
  288.  
  289.   o   And whatever improvements I can think of.
  290.  
  291. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  292.   
  293.       I would appreciate any comments or suggestions that you may have on
  294.       the program and what else you would like to see in a program of this
  295.       nature in future releases.  If you have any suggestions please call
  296.       the 21st Century BBS and leave me a message or write to the above
  297.       listed address.
  298.  
  299.                               Thanx BB
  300.  
  301.